home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 151-175 / scopedisk169 / itracker.mus / itracker.doc < prev    next >
Text File  |  1995-03-19  |  15KB  |  472 lines
  1.  
  2. January, 1990            IntuiTracker V1.1              Shareware $10
  3. =====================================================================
  4.                    by
  5.  
  6.                  WiseGuy
  7.                    of
  8.                 ­TRIUMPH­
  9.  
  10.             alias: Jan-Ivar Bruarøy
  11.  
  12.  
  13. IntuiTracker V1.1 is a soundtrack module-player.
  14.  
  15. IntuiTracker is an attempt to bring the music-world of the popular
  16. Soundtracker/Noisetracker programs, to the common amiga-user.
  17.  
  18.  
  19. IT's purpose is to play music of your choice in a multitasking-
  20. friendly manner. This gives you the opportunity to listen to your
  21. favourite Amiga 8-bit-digital-stereo-music-trax while you do other
  22. things, like programming, writing, painting, downloading or whatever
  23. you do with your amiga. (No! you can't use IT with "Xenon II"!)
  24.  
  25. Sure, you could just turn on the CD or cassette player, I hear you
  26. argue. Ok, but haven't you ever been humming on a tune from a game
  27. or a demo, while doin' some coding ? No? (I have!)
  28.  
  29. With IntuiTracker you can have your own collections of songs on
  30. either disks or on your harddisk.
  31. (At present I have about 10 Mb of modules on my harddisk!)
  32.  
  33. Features:
  34.     - Supports Soundtracker V2.0 - 2.5 and
  35.                    Noisetracker V1.0 - 1.1 modules.
  36.     - Multitasking friendly.
  37.     - Control panel for easy control of play.
  38.     - Volume control
  39.     - Graphic spectrum-equalizer display
  40.     - Programmable sequence of play of selected modules.
  41.     - Random play of selected modules.
  42.     - Introduces new format for Composers to sign their work (*)
  43.     - Leave a song playing, when exiting program.
  44.  
  45. *) - musicians: read chapter 6!
  46.     
  47.  
  48. 1. SHAREWARE:
  49.    ~~~~~~~~~~
  50. This program is released as shareware. This means that if you like
  51. this utility, you should express it by sending around $10
  52. to the the author (that's me).
  53. I will mail you updates of this program when available, (if you don't
  54. specify otherwise). I will charge for the disk only.
  55.  
  56. The address is:         Jan-Ivar Bruarøy,
  57.              Tiurstien 31a,
  58.              3190 Horten,
  59.              NORWAY.
  60.  
  61. I can be reached on these norwegian BBS's:
  62.  
  63. Crusaders BBS:    (068) 10881    or    MediaFoto BBS:    (02) 176056
  64.  
  65. Bug-reports or suggestions for improvements are welcome.
  66.  
  67.  
  68. 2. INSTRUCTIONS:
  69.    ~~~~~~~~~~~~~
  70. IntuiTracker V1.1 will play music produced by:
  71. Soundtracker V2.0 - V2.5 or Noisetracker 1.0 - 1.1 or compatibles.
  72. Songs must be saved (or ripped) as ´modules´ in order to be played.
  73.  
  74. (Nearly all songs on demos and most games are made on a
  75.  Soundtracker program. There are several soundtrack module-rippers
  76.  available that will extract these as modules for you.)
  77.  
  78. IntuiTracker can be started from either CLI or Workbench.
  79. Click on the IntuiTracker-window to access the menus.
  80.  
  81.  
  82. ENOUGH BULLSHIT, HOW DO I PLAY A SONG ?!
  83. Ok.
  84.  
  85. 1. Find a disk which you know has some soundtracker-modules on it.
  86.    (Any soundtracker disk or a music-collection disk that's not
  87.     crunched and not a NON-DOS disk should do.)
  88.  
  89. 2. Click on the IntuiTracker-window.
  90.    Choose the menu/menuitem:  Tracks/Choose Disc.
  91.  
  92. 3. Enter the name of the disk:directory where the module is located.
  93.    (Probably DF0:modules or just DF0:)
  94.  
  95. 4. After loading, examine the Tracks-menu. If a module-name has
  96.    appeared, select it.
  97.  
  98.    If no names appear, don't panic.
  99.    do this:
  100.  
  101.     - Select the menu/menuitem:  Prefs/MOD.files ONLY
  102.       (The checkmark should now be off.)
  103.     - Do step 2, 3 and 4 again.
  104.  
  105.     (Explanation: IT assumes all module-names begin with: "MOD."
  106.               When you do step 4, IT will treat ALL files
  107.               as modules. BE CAREFUL; Trying to load a file
  108.               that NOT an ST-module is generally not healthy! )
  109.  
  110. 5. The song should now be loaded and played.
  111.  
  112. 6. You can select PREFS/Equalizer and PREFS/Control Panel to get
  113.    some action.
  114.  
  115.  
  116.  
  117. 3. MENUS:    The following is an explanation of the menus:
  118.    ~~~~~~
  119.  
  120. Menu: Control -
  121.  
  122.    PLAY/PAUSE/STOP - Obvious.
  123.  
  124.    EJECT       - Removes song from memory. To play it again, it
  125.              has to be reloaded.
  126.  
  127.    PLAY NEXT        - Loads and plays the next song on the menu.
  128.              In PROGRAM MODE the next in sequence will be
  129.              loaded.
  130.  
  131.              If RANDOM PLAY is active, the song to be loaded
  132.              will be a song on the menu chosen at random.
  133.              With RANDOM PLAY in PROGRAM MODE the songs
  134.              chosen at random is limited to the those
  135.              which are programmed.
  136.  
  137.    PLAY PREV        - Loads and plays the previous song on the menu.
  138.  
  139.    PROGRAM MODE       - This command allows you to program IntuiTracker
  140.              to play several songs in a certain order.
  141.  
  142.              To program, select this menu-item.
  143.              The text "Select tracks" should appear in the
  144.              window.
  145.  
  146.              - Enter the "Tracks"-menu.
  147.                The first menu-item has now changed to:
  148.                "END PROGRAMMING"
  149.  
  150.              - Select the songs you wish to enter in the
  151.                program, in the order you want them to be
  152.                played. 
  153.                The menu-item's short-keys will indicate the
  154.                order you have chosen.
  155.  
  156.                (HINT: You can multi-select songs by pressing
  157.                   the left button and drag the mouse over
  158.                       several items)
  159.  
  160.              - To remove an item, just select it again.
  161.  
  162.              - When you're finished, select END PROGRAMMING,
  163.                and the first song in the program will be
  164.                loaded.
  165.  
  166.              - Program is now running.
  167.  
  168.              - To end program mode and go back to normal
  169.                operation, select PROGRAM MODE again.
  170.                (checkmark will disappear.)
  171.  
  172.  
  173.    REPEAT SONG     - Option. Checkmark indicates ON.
  174.  
  175.              When this option is on, a loaded song will play
  176.              continuously until the user desides otherwise.
  177.              This is the default.
  178.  
  179.              When this option is off, the song will stop when
  180.              the final position in the song has finished,
  181.              or when a position-jump to an earlier position
  182.              is found.
  183.  
  184.              When in PROGRAM MODE, this option is called:
  185.              REPEAT PRG, and it enables/disables repeat of
  186.              the whole program sequence.
  187.  
  188.    RANDOM PLAY       - Option. Checkmark indicates ON.
  189.  
  190.              Random play affects the sequence of play in
  191.              PROGRAM MODE.
  192.              It also affects the use of the PLAY NEXT
  193.              and the PLAY PREVIOUS commands in both PROGRAM
  194.              MODE and normal mode.
  195.              The default is off.
  196.  
  197.    ABOUT           - Checkmark indicates ON.
  198.              When a song is played, turning on this option
  199.              will (when possible) display the name of the
  200.              composer for that song.
  201.              (musicians: see notes in chapter 6)
  202.  
  203.              If no song is loaded, this option gives you
  204.              some additional notes on IntuiTracker.
  205.  
  206.    LEAVE SONG       - Will quit IntuiTracker, but the last song will
  207.              keep on playing. In technical terms:
  208.              The program is unloaded, but the player-
  209.              interrupt remains.
  210.  
  211.              If REPEAT SONG is on when you exit this way,
  212.              the song will go on forever.
  213.              If REPEAT SONG is off, the interrupt will kill
  214.              itself when the song finishes, and memory
  215.              will be free'd.
  216.  
  217.              Note that IT can intercept this playing
  218.              interrupt again the next time you start IT.
  219.  
  220.    QUIT           - Unloads everything.
  221.  
  222.  
  223.  
  224. Menu: Prefs -
  225.  
  226.     The following menu-items are all options.
  227.     Checkmarks indicate ON.
  228.  
  229.  
  230.    VOLUME CONTROL  - \
  231.    EQUALIZER       -  X Check it out!
  232.    CONTROL PANEL   - /
  233.  
  234.    NONE            - Turns off the three above.
  235.  
  236.    FILTER          - Turns the amiga hardware low-pass filter
  237.              (and the LED) on or off.
  238.              This does not works on Amiga 1000.
  239.              The default is off.
  240.  
  241.              A soundtracker song has the option to turn the
  242.              filter on or off by itself. This will by default
  243.              override the IntuiTracker setting.
  244.              Some ST-musicians tend to mis-use the filter
  245.              by flashing the LED, with their soundtracks.
  246.  
  247.              By selecting the FILTER OVERRIDE switch on
  248.              IntuiTracker, the filter settings in each song
  249.              will be ignored, and the IT setting is final.
  250.  
  251.    DEPTH GADGET    - Gives the IntuiTracker-window depth gadgets.
  252.              Because of lack of space and cosmetic reasons,
  253.              this defaults to off.
  254.  
  255.              When depth gadgets are off, the window is pushed
  256.              to the front when you active it.
  257.  
  258.    MOD.files ONLY  - IntuiTracker, as default, expects all module
  259.              files to begin with the letters "MOD.".
  260.              If they don't, they wont appear on the menu.
  261.              Turning "MOD.files ONLY" off will make IT
  262.              accept all filenames as valid module-files.
  263.  
  264.              The Noisetracker versions and the earlier
  265.              Soundtracker versions all defaults to writing
  266.              the "MOD." prefix on all modules they save.
  267.              Soundtracker V2.4 and V2.5 has regretably
  268.              dropped this.
  269.              I say regretably because a soundtrack-module
  270.              as a result of it's crowded format, is hard to
  271.              distinguish from other files.
  272.  
  273.              Note that, although IntuiTracker checks the
  274.              files being loaded, you should avoid trying
  275.              to load any NON ST/NT-module files, as
  276.              the checking routines aren't fail-safe.
  277.  
  278.  
  279.   MUSIQUE NON-STOP - When IT loads a new song, by user command, or
  280.              as a part of a program sequence, it will, if
  281.              chip-memory allows it, load the new song without
  282.              cutting off of the song being played.
  283.              This gives you as much uninterrupted listening
  284.              pleasure as possible.
  285.              (In a program-sequence, this is done by
  286.               pre-loading the following song, before the
  287.               current has finished.)
  288.  
  289.              With this method, however, IT needs to have both
  290.              songs in memory at one time. This is very
  291.              memory-intensive, and it may also fragment
  292.              your memory if you use other memory-intensive
  293.              programs at the same time.
  294.  
  295.              Therefore; If memory is a concern, you use this
  296.              option to turn off the non-stop loading technique.
  297.              (The default is on.)
  298.  
  299.  
  300. 4. CONTROL PANEL:
  301.    ~~~~~~~~~~~~~~
  302. The control panel has the following set of gadgets:
  303.  
  304. +---+---+--------+--------+--------+--------+--------+-------+-------+
  305. | + | - |   |<   |   <<   |   |>   |   >>   |   >|   |   .   |   ^   |
  306. +---+---+--------+--------+--------+--------+--------+-------+-------+
  307.  
  308.   |>           - PLAY/PAUSE (*)
  309.  
  310.   .              - STOP (*)
  311.  
  312.   ^              - EJECT (*)
  313.  
  314.   >> / <<          - Forward / Rewind. Moves through positions in song.
  315.  
  316.   >|             - PLAY NEXT (*)
  317.  
  318.   |<             - PLAY PREVIOUS (*)
  319.  
  320.   + / -           - Changes the speed of play-back.
  321.              A soundtracker-song may change it's speed
  322.              during play. Since you may start a song from
  323.              any position, the speed may not be set correctly.
  324.              These gadgets are useful for correcting this.
  325.  
  326.              Pressing PAUSE or STOP cancels your changes.
  327.  
  328. 5. GENERAL NOTES ON FORMAT:
  329.    ~~~~~~~~~~~~~~~~~~~~~~~~
  330. As mentioned earlier, IntuiTracker assumes all module files begin
  331. with the letters "MOD.". Although the "MOD.files ONLY" option will
  332. allow you to load ANY kind of file, I strongly suggest that when you
  333. make a collection directory of your modules that you rename your
  334. files appropriately.
  335.  
  336. If you have the ARP rename command installed in your system this can
  337. be done quite easily by entering your directory and typing:
  338.  
  339.     rename * to mod.*
  340.  
  341.  
  342. As a rule for future expansion, IT will also accept the following
  343. extension formats:    ".Snn"  and  ".Nnn"
  344.  
  345. ex:        TRIUMPH.S25    and    TRIUMPH.N11
  346.  
  347. These extensions indicate the soundtracker or noisetracker version
  348. used to create the module. The versions in the example are
  349. Soundtracker V2.5 and NoiseTracker V1.1 respectively.
  350.  
  351. PLEASE NOTE that these extensions have NO bearing on IT's treatment
  352. of the modules. The ".Snn" and ".Nnn" extensions are for future
  353. compatibility, or for your own reference only.
  354. This version of IntuiTracker handles all formats without distinction.
  355.  
  356.  
  357.  
  358. 6. NOTES FOR MUSICIANS:
  359.    ~~~~~~~~~~~~~~~~~~~~
  360.  
  361. Intuitracker's author/composer format:
  362.  
  363. IntuiTracker introduces a new way for composers to put their name on
  364. a musicpiece.
  365. Soundtracker (and Noisetracker) stores the names of the instruments
  366. in each module. If instead of the name of an instrument; f.ex.
  367.  
  368.     st-01:bassdrum
  369.  
  370. you enter something like this:
  371. (in any of the first -16- Instrument-name spots)
  372.  
  373.     #Hellraiser of Triumph.
  374.  
  375. the following will appear when selecting ABOUT on IntuiTracker:
  376.  
  377.     "Some song" - Composed by Hellraiser of Triumph.
  378.  
  379. Please note the '#' character in front of the control string.
  380. (Use SHIFT-3 on Soundtracker,
  381.  use SHIFT and the key to the left of [RETURN] on Noisetracker.)
  382.  
  383. If you need more room, just use more '#'-control strings.
  384. The text will appear continous.
  385.  
  386. NOTE! - You can only have up to five (5) '#'-control strings in
  387.         one module. This gives you about 100 bytes to write in.
  388.        - All '#'-control strings must be on the FIRST 16 instruments.
  389.  
  390.  
  391. IT'S UP TO YOU TO USE THIS TECHNIQUE !  IF YOU WANT FAME, USE IT !
  392.  
  393. If no-one supports it, it will be of no use !
  394.  
  395. 7. WARNING!
  396.    ~~~~~~~~
  397. 1. Intuitracker has been carefully tested for bugs, and should under
  398.    normal circumstances not crash your machine.
  399.    (This is no guarrantee though. If this DOES happen, let me know!).
  400.    Please note however that due to the memory-intensive nature of
  401.    IT's operation, running a large music-piece on IT simultaniously
  402.    with other programs, may cause OTHER programs to crash!
  403.    Many Amiga programs (including the workbench!) may crash when
  404.    it runs out of chip-memory.
  405.  
  406.    You should therefore always keep an eye on your chip-memory,
  407.    when using IntuiTracker.
  408.    Ejecting a song after you are done with it frees up chip-memory,
  409.    so does turning off the equalizer window, etc.
  410.  
  411. 2. FOR HARDDISK USERS, a system crash can be fatal if the system
  412.    crashes while you are saving to your harddisk.
  413.    IntuiTracker works absolutely fine with my harddisk and my system-
  414.    configuration. All I am saying is, that until you get aqueinted
  415.    with IntuiTracker, take it easy. Make sure it works with your
  416.    system. I hope you understand I can take no responsibility for
  417.    any mis-haps. This product is delivered "as is".
  418.  
  419. Have this in mind when you use IntuiTracker. 
  420.  
  421.  
  422. If you find any bugs with this version, please feel free to
  423. write me a letter, explaining the problem.
  424.  
  425.  
  426.  
  427. 8. CHANGES:
  428.    ~~~~~~~~
  429.     V1.0 -    (90.01.21) Rushed release.
  430.  
  431.     V1.1 -    (90.01.23) Major bug fix! First release had a
  432.         fatal bug that crashed the system. Do not use V1.0!
  433.  
  434.  
  435. 9. FUTURE VERSIONS:
  436.    ~~~~~~~~~~~~~~~~
  437. Future versions are planned. This is in order to keep up with
  438. new soundtracker versions, and to generally improve the program and
  439. add features. Your support by sending in the above-mentioned fee is
  440. important to this progress. If you do this, you will automatically
  441. recieve all future releases.
  442.  
  443. future improvements will be:
  444.     - more than 22(PAL)/18(NTSC) tracks on menu!
  445.     - better loading (multitasking)
  446.     - support for crunched modules
  447.     - CLI parameters for auto-loading of songs, for use with
  448.       slideshows, demos etc.
  449.     - selection of modules by Icon.
  450.     - aRexx interface.
  451.     - better memory-checking
  452.     - better key-shortcuts.
  453.     - optional space-invaders
  454.  
  455.  
  456.  
  457.  
  458. 10. DISTRIBUTION/DISCLAIMER:   (C) 1990 Jan Ivar Bruarøy.
  459.     ~~~~~~~~~~~~~~~~~~~~~~~~
  460. This program may be distributed for non-commercial use by
  461. any means as long as:
  462.    1) the program, it's icon and this document file are
  463.       distributed together.
  464.    2) the program, this file, or any part thereof, is not
  465.       modified or removed.
  466. These rights may not be abridged except by written permis-
  467. sion from the author. The author makes no warranties, ex-
  468. pressed or implied. This program is provided "as is" and the
  469. entire risk as to its quality and performance is with the
  470. user. The author is not responsible for losses due
  471. to the use of this program.
  472.